home *** CD-ROM | disk | FTP | other *** search
/ Canadian Geographic Explorer / Canadian Geographic Explorer.iso / pc / comp.z / PROJ.HLP < prev    next >
Encoding:
Text File  |  1996-05-01  |  53.9 KB  |  1,312 lines

  1. @title{PROJ}{Projection Reference}
  2. @keyword{kernel projections parameter georeference segment set}
  3. @index{Projections}
  4.  
  5.  Why are projections needed for image processing?  Projections are 
  6.  required to tie-down an image to the earth's surface.  Once the
  7.  required projection information has been defined and the image
  8.  has been corrected to overlay the projection bounds, image
  9.  equirectangular pixel and line coordinates can be transformed
  10.  to produce equirectangular projection easting and northing
  11.  coordinates which can be transformed with the projection formulas
  12.  to produce equivalent non-equirectangular longitude and latitude
  13.  coordinates.  Or the inverse can be done: longitude and latitude
  14.  coordinates can be transformed to projection easting and northings
  15.  and image database pixel and line coordinates.
  16.  
  17.  Projections are useful to compensate for distortions in large-scale
  18.  imagery that cover a large earth surface, where distortions are
  19.  produced from earth curvature.  These are the same distortions 
  20.  that occur in projecting a spherical surface (the earth) onto a
  21.  flat surface (the image database).  Although there are still
  22.  distortions in all projections, some are removed or compensated
  23.  for depending on the projection used.
  24.  
  25.  Once an image is tied to one projection, it can automatically be
  26.  projected to overlay another projection.  This gives you options
  27.  to easily process your data, by matching your goals to the 
  28.  appropriate projection.
  29.  
  30.  The software used for the projection transforms is the GCTP
  31.  (General Cartographic Transformation Package) produced by the
  32.  U.S. Geological Survey (See the REFERENCES section.).  It can
  33.  be used to convert:
  34.  
  35.  - projection coordinates to geographic coordinates
  36.  - geographic coordinates to projection coordinates
  37.  - projection coordinates to coordinates in a second projection
  38.  
  39.  The conversions must use the same earth model (ellipsoid or sphere).
  40.  The package is NOT meant to be used to convert between systems with 
  41.  different earth models.
  42.  
  43.  Transforming between projections with different earth models 
  44.  requires an actual geometric correction using a first-order affine 
  45.  transform (offsets and possibly scaling and rotation).  Transforms 
  46.  between different earth models is discussed more under the EARTH_MODELS 
  47.  section in program REGPRO.
  48.  
  49. 1    OUTPUT UNITS
  50.  
  51.  For supported projections, the output map units will take the 
  52.  following output format:
  53.  
  54.   'proj 9999 r Ennn'
  55.  
  56.   Where: proj (Characters 1 to 4) is the standard string listed below
  57.          for the projection.  The string is left-justified.  If 
  58.          the standard string is less than 4 characters the string
  59.          is padded with trailing blanks.  (e.g. 'UTM ')
  60.  
  61.         (Character 5 is blank)
  62.  
  63.         9999 (Characters 6 to 9) is the zone number, if any.
  64.           - for the UTM projection, depending on the value of 
  65.             the subroutine argument UTMROW, the zone number is
  66.             returned right-justified in the range of '   1' to 
  67.             '  60' (or '  -1' to ' -60').
  68.           - for SPCS projections:  '0101' to '5400'
  69.           - for other projections: '    '
  70.  
  71.         (Character 10 is blank)
  72.  
  73.         r (Character 11) is the UTM or UPS grid zone row, if any.
  74.           For all other systems, this is blank.
  75.          
  76.         (Character 12 is blank)
  77.  
  78.         Ennn (Characters 13 to 16) Ellipsoid used for the projection
  79.           - 'E000' to E019' for supported ellipsoids
  80.           - Default is 'E000' if no earth model is defined in
  81.             MAPUNITS or ELLIPS
  82.           - 'E999' is a special case, where the earth model is
  83.             not supported but was defined in ELLIPS
  84.  
  85. 1    EARTH MODELS
  86.  
  87.  The following earth models are supported.
  88.  
  89.   Standard  
  90.    String    Descriptor                   Notes
  91.  
  92.   E000       Clarke                1866   NAD1927
  93.   E001       Clarke                1880   
  94.   E002       Bessel                1841   
  95.   E003       New International     1967   
  96.   E004       International         1924   Hayford 1909
  97.   E005       WGS                   1972   
  98.   E006       Everest               1830   
  99.   E007       WGS                   1966   
  100.   E008       GRS                   1980   NAD1983
  101.   E009       Airy                  1830   
  102.   E010       Modified Everest             
  103.   E011       Modified Airy                
  104.   E012       WGS                   1984   GPS
  105.   E013       Southeast Asia               
  106.   E014       Australian National   1965   
  107.   E015       Krassovsky            1940   
  108.   E016       Hough                        
  109.   E017       Mercury               1960   
  110.   E018       Modified Mercury      1968   
  111.   E019       Sphere, rad 6370997 m        Normal Sphere
  112.  
  113.   E999       Unsupported earth model, where the earth model fields
  114.              are defined in an existing georeference segment.
  115.  
  116. @pagebreak
  117.                                     Semi-Major      Semi-Minor
  118.                                      Axis (A)        Axis (B)
  119.   ELLIPS  Descriptor                 (metres)        (metres)
  120.  
  121.    0      Clarke            1866  6378206.400000  6356583.800000
  122.    1      Clarke            1880  6378249.145000  6356514.869550
  123.    2      Bessel            1841  6377397.155000  6356078.962840
  124.    3      New International 1967  6378157.500000  6356772.200000
  125.    4      International     1924  6378388.000000  6356911.946130
  126.    5      WGS               1972  6378135.000000  6356750.519915
  127.    6      Everest           1830  6377276.345200  6356075.413300
  128.    7      WGS               1966  6378145.000000  6356759.769356
  129.    8      GRS               1980  6378137.000000  6356752.314140
  130.    9      Airy              1830  6377563.396000  6356256.910000
  131.   10      Modified Everest        6377304.063000  6356103.039000
  132.   11      Modified Airy           6377340.189000  6356034.448000
  133.   12      WGS               1984  6378137.000000  6356752.314245
  134.   13      Southeast Asia          6378155.000000  6356773.320500
  135.   14      Australian Nat    1965  6378160.000000  6356774.719000
  136.   15      Krassovsky        1940  6378245.000000  6356863.018800
  137.   16      Hough                   6378270.000000  6356794.343479
  138.   17      Mercury           1960  6378166.000000  6356784.283666
  139.   18      Modified Mercury  1968  6378150.000000  6356768.337303
  140.   19      Normal Sphere           6370997.000000  6370997.000000
  141.  
  142.  As it stands, the U.S.G.S. GCTP software, that is used by 
  143.  EASI/PACE programs for conversions between projections, does not 
  144.  convert coordinates between different earth ellipsoids or datums.  
  145.  However there is software available to the public for conversion 
  146.  of NAD1927 coordinates to NAD1983 coordinates.  For Canadian users,
  147.  you can contact the following for the National Transformation 
  148.  package (Version 1.1):
  149.  
  150.    Geodetic Survey Division,
  151.    615 Booth Street,
  152.    Ottawa, Ontario
  153.    K1A 0E9
  154.    Tel: (613) 992-2706, (613) 995-2613
  155.    Fax: (613) 995-3215
  156.  
  157.  The National Transformation package is also available through
  158.  the Provincial Survey Agencies.
  159.  
  160.  For American users, you can contact the following for the NADCON
  161.  package:
  162.  
  163.    National Geodetic Information Center,
  164.    N/CG174, Rockwall Bldg., Room 24,
  165.    National Geodetic Survey, NOAA,
  166.    Rockville, Maryland 20852
  167.    Tel: (301) 443-8631
  168.    Fax: (301) 881-0154
  169.  
  170. 1    UTM ZONES
  171.  
  172.  The Universal Transverse Mercator projection divides the earth 
  173.  into 60 UTM zones.  Each zone is 6 degrees wide in longitude.
  174.  The central meridian for the projection is in the middle of the 
  175.  UTM zone.  (The reference latitude for all UTM zones is the equator.)
  176.  
  177.   UTM       Zone        Central         UTM       Zone        Central
  178.   Zone      Range       Meridian        Zone      Range       Meridian
  179.    1    180W - 174W      177W           31      0E -   6E        3E
  180.    2    174W - 168W      171W           32      6E -  12E        9E
  181.    3    168W - 162W      165W           33     12E -  18E       15E
  182.    4    162W - 156W      159W           34     18E -  24E       21E
  183.    5    156W - 150W      153W           35     24E -  30E       27E
  184.    6    150W - 144W      147W           36     30E -  36E       33E
  185.    7    144W - 138W      141W           37     36E -  42E       39E
  186.    8    138W - 132W      135W           38     42E -  48E       45E
  187.    9    132W - 126W      129W           39     48E -  54E       51E
  188.   10    126W - 120W      123W           40     54E -  60E       57E
  189.   11    120W - 114W      117W           41     60E -  66E       63E
  190.   12    114W - 108W      111W           42     66E -  72E       69E
  191.   13    108W - 102W      105W           43     72E -  78E       75E
  192.   14    102W -  96W       99W           44     78E -  84E       81E
  193.   15     96W -  90W       93W           45     84E -  90E       87E
  194.   16     90W -  84W       87W           46     90E -  96E       93E
  195.   17     84W -  78W       81W           47     96E - 102E       99E
  196.   18     78W -  72W       75W           48    102E - 108E      105E
  197.   19     72W -  66W       69W           49    108E - 114E      111E
  198.   20     66W -  60W       63W           50    114E - 120E      117E
  199.   21     60W -  54W       57W           51    120E - 126E      123E
  200.   22     54W -  48W       51W           52    126E - 132E      129E
  201.   23     48W -  42W       45W           53    132E - 138E      135E
  202.   24     42W -  36W       39W           54    138E - 144E      141E
  203.   25     36W -  30W       33W           55    144E - 150E      147E
  204.   26     30W -  24W       27E           56    150E - 156E      153E
  205.   27     24W -  18W       21W           57    156E - 162E      159E
  206.   28     18W -  12W       15W           58    162E - 168E      165E
  207.   29     12W -   6W        9W           59    168E - 174E      171E
  208.   30      6W -   0E        3W           60    174E - 180W      177E
  209.  
  210. 1    UTM GRID ZONES
  211.  
  212.  UTM zones divide the earth into columns, west to east.  Each UTM
  213.  zone can be divided into rows, south to north.  If both the UTM
  214.  zone and row are given, the area defined is referred to as a
  215.  UTM grid zone.  For example UTM30N is the area just west of
  216.  Greenwich and just north of the equator.
  217.  
  218.  A UTM grid zone can be divided further.  However within EASI/PACE,
  219.  the row is only used to determine if the coordinates are north or
  220.  south of the equator.  If the UTM zone is defined and the row is not,
  221.  the coordinates are assumed to be north of the equator.  Coordinates
  222.  north of the equator are assumed to have a false northing of 0.0
  223.  metres while coordinates south of the equator are assumed to have a
  224.  false northing of 10000000.0 metres.
  225.  
  226.   UTM        Row                        UTM        Row
  227.   Row       Range                       Row       Range
  228.   C      80S -  72S                     N       0N -   8N
  229.   D      72S -  64S                     P       8N -  16N
  230.   E      64S -  56S                     Q      16N -  24N
  231.   F      56S -  48S                     R      24N -  32N
  232.   G      48S -  40S                     S      32N -  40N
  233.   H      40S -  32S                     T      40N -  48N
  234.   J      32S -  24S                     U      48N -  56N
  235.   K      24S -  16S                     V      56N -  64N
  236.   L      16S -   8S                     W      64N -  72N
  237.   M       8S -   0N                     X      72N -  84N
  238.  
  239.   Note: - There is no row I or row O.
  240.         - All rows are 8 degrees latitude, except row X which has
  241.           12 degrees latitude.
  242.         - Grid zones A, B, Y, and Z exist, but are not valid for
  243.           the UTM projection.  They are used for the polar regions
  244.           (A and B for the South Pole;  Y and Z for the North Pole),
  245.           which are mapped with the Universal Polar Stereographic
  246.           (UPS) projection.
  247.  
  248. 1    UPS GRID ZONES
  249.  
  250.  In the UPS grid system, which is used instead of UTM in the
  251.  polar areas, each circular polar zone is divided in half by the
  252.  the Prime Meridian (0 degrees Longitude) and 180 degrees Longitude
  253.  (East or West).  There are two grid zones over the North Pole
  254.  (Y and Z) and two over the South Pole (A and B).
  255.  
  256.  A UPS grid zone can be divided further.  However within EASI/PACE,
  257.  the grid zone is only used to determine if the coordinates are at
  258.  the North or South Pole.
  259.  
  260.   UPS Grid Zone    Longitude Range    Latitude Range
  261.  
  262.        A             180W -   0W        90S - 80S
  263.        B               0E - 180E        90S - 80S
  264.  
  265.        Y             180W -   0W        84N - 90N
  266.        Z               0E - 180E        84N - 90N
  267.  
  268.   Note: - Grid zones C to X (but not I or O) exist, but are not valid
  269.           for the UPS projection.  They are supported for the UTM
  270.           projection.
  271.  
  272. 1    SPCS ZONES
  273.  
  274.  The United States of America uses the State Plane Coordinate System 
  275.  as a system of plane rectangular coordinates that may be used
  276.  for measuring ground distance and area.  SPCS uses specified
  277.  projections with set characteristics.  In general, Transverse Mercator
  278.  (TM) is used for States with predominant north-south extent and
  279.  Lambert Conformal Conic (LCC) is used for States with predominant
  280.  east-west extent.  Other projections that may be used are Oblique
  281.  Mercator (OM) in Alaska and Polyconic (PC) in Guam.  The 
  282.  characteristics for each projection are stored in text files 
  283.  "nad1927.txt" and "nad1983.txt" that are provided in the 
  284.  $PCIHOME/etc subdirectory.
  285.  
  286.  The following is a list of codes for specifying State Plane zones.
  287.  The "Zone Name or Number", "Alpha Code" and "Proj Type" are for your
  288.  information and are NOT to be used to specify SPCS zones.  The
  289.  "zone unit code" is used instead.  For example, to specify the zone for
  290.  Alabama, East you would set MAPUNITS to "spaf 0101" (or "SPAF 101").
  291.  The "units" can be upper or lower-case.  The "code" can have (but doesn't
  292.  require) leading zeros.
  293.  
  294.  State Plane coordinates are only supported for NAD1927 (which
  295.  uses Clarke 1866 ellipsoid) or NAD1983 (which uses the GRS 1980
  296.  ellipsoid).
  297.  
  298.  The units for a given zone will be derived from the units string typed in
  299.  where:
  300.  
  301.  "SPAF" stands for "State Plane (U.S. Survey Feet)", 
  302.         where 1.0 inch of a "U.S. Survey Foot" equals APPROXIMATELY 25.4005 mm.
  303.        (where 1.0 metre equals EXACTLY 39.37 inches)
  304.  
  305.  "SPIF" stands for "State Plane (International Foot)",
  306.         where 1.0 inch of an "International Foot" equals EXACTLY 25.4 mm.
  307.  
  308.  "SPCS" stands for "State Plane (Metres)"
  309.  
  310.  For NAD27, the units are "SPAF" (i.e. "State Plane (U.S. Survey Feet)").
  311.  For NAD83, the units listed are those specified by State Laws as of
  312.  February 1, 1992.  Although these are the suggested units, they may be
  313.  overridden.
  314.  
  315.  Any of the following work for the above example for NAD27.  (The
  316.  first example assumes NAD 1927, if no earth model is specified.)
  317.  
  318.   MAPUNITS="spaf 101"      \ ELLIPS=    \
  319.   MAPUNITS="spaf 101 e0"   \ ELLIPS=    \
  320.   MAPUNITS="spaf 101"      \ ELLIPS="0" \
  321.  
  322.  Any of the following work for the above example for NAD83.
  323.  
  324.   MAPUNITS="spaf 101 e8"    \ ELLIPS=    \
  325.   MAPUNITS="spaf 101"       \ ELLIPS="8" \
  326.  
  327.  The following list is copied from Appendix A of the U.S.G.S.
  328.  "GCTP, General Cartographic Transformation Package Software
  329.  Documentation".
  330.  
  331.                                              NAD27        NAD83
  332.                           Alpha    Proj      zone         zone
  333.   Zone Name or Number     code     type    unit code    unit code
  334.  
  335.   Alabama                 AL
  336.       East                         TM      SPAF 0101    SPAF 0101
  337.       West                         TM      SPAF 0102    SPAF 0102
  338.  
  339.   Alaska                  AK
  340.       01                           OM      SPAF 5001    SPCS 5001
  341.       02                           TM      SPAF 5002    SPCS 5002
  342.       03                           TM      SPAF 5003    SPCS 5003
  343.       04                           TM      SPAF 5004    SPCS 5004
  344.       05                           TM      SPAF 5005    SPCS 5005
  345.       06                           TM      SPAF 5006    SPCS 5006
  346.       07                           TM      SPAF 5007    SPCS 5007
  347.       08                           TM      SPAF 5008    SPCS 5008
  348.       09                           TM      SPAF 5009    SPCS 5009
  349.       10                           LCC     SPAF 5010    SPCS 5010
  350.  
  351.   Arizona                 AZ
  352.       East                         TM      SPAF 0201    SPIF 0201
  353.       Central                      TM      SPAF 0202    SPIF 0202
  354.       West                         TM      SPAF 0203    SPIF 0203
  355.  
  356.   Arkansas                AR
  357.       North                        LCC     SPAF 0301    SPAF 0301
  358.       South                        LCC     SPAF 0302    SPAF 0302
  359.  
  360.   California              CA
  361.       01                           LCC     SPAF 0401    SPAF 0401
  362.       02                           LCC     SPAF 0402    SPAF 0402
  363.       03                           LCC     SPAF 0403    SPAF 0403
  364.       04                           LCC     SPAF 0404    SPAF 0404
  365.       05                           LCC     SPAF 0405    SPAF 0405
  366.       06                           LCC     SPAF 0406    SPAF 0406
  367.       07                           LCC     SPAF 0407    ---------
  368.  
  369.   Colorado                CO
  370.       North                        LCC     SPAF 0501    SPIF 0501
  371.       Central                      LCC     SPAF 0502    SPIF 0502
  372.       South                        LCC     SPAF 0503    SPIF 0503
  373.  
  374.   Connecticut             CT       LCC     SPAF 0600    SPAF 0600
  375.  
  376.   Delaware                DE       TM      SPAF 0700    SPAF 0700
  377.  
  378.   District of Columbia    DC   Use LCC     SPAF 1900    SPAF 1900
  379.  
  380.   Florida                 FL
  381.       East                         TM      SPAF 0901    SPAF 0901
  382.       West                         TM      SPAF 0902    SPAF 0902
  383.       North                        LCC     SPAF 0903    SPAF 0903
  384.  
  385.   Georgia                 GA
  386.       East                         TM      SPAF 1001    SPCS 1001
  387.       West                         TM      SPAF 1002    SPCS 1002
  388.  
  389.   Hawaii                  HI
  390.       01                           TM      SPAF 5101    SPAF 5101
  391.       02                           TM      SPAF 5102    SPAF 5102
  392.       03                           TM      SPAF 5103    SPAF 5103
  393.       04                           TM      SPAF 5104    SPAF 5104
  394.       05                           TM      SPAF 5105    SPAF 5105
  395.  
  396.   Idaho                   ID
  397.       East                         TM      SPAF 1101    SPAF 1101
  398.       Central                      TM      SPAF 1102    SPAF 1102
  399.       West                         TM      SPAF 1103    SPAF 1103
  400.  
  401.   Illinois                IL
  402.       East                         TM      SPAF 1201    SPAF 1201
  403.       West                         TM      SPAF 1202    SPAF 1202
  404.  
  405.   Indiana                 IN
  406.       East                         TM      SPAF 1301    SPAF 1301
  407.       West                         TM      SPAF 1302    SPAF 1302
  408.  
  409.   Iowa                    IA
  410.       North                        LCC     SPAF 1401    SPCS 1401
  411.       South                        LCC     SPAF 1402    SPCS 1402
  412.  
  413.   Kansas                  KS
  414.       North                        LCC     SPAF 1501    SPAF 1501
  415.       South                        LCC     SPAF 1502    SPAF 1502
  416.  
  417.   Kentucky                KY
  418.       North                        LCC     SPAF 1601    SPAF 1601
  419.       South                        LCC     SPAF 1602    SPAF 1602
  420.  
  421.   Louisiana               LA
  422.       North                        LCC     SPAF 1701    SPCS 1701
  423.       South                        LCC     SPAF 1702    SPCS 1702
  424.       Offshore                     LCC     SPAF 1703    SPCS 1703
  425.  
  426.   Maine                   ME
  427.       East                         TM      SPAF 1801    SPCS 1801
  428.       West                         TM      SPAF 1802    SPCS 1802
  429.  
  430.   Maryland                MD       LCC     SPAF 1900    SPAF 1900
  431.  
  432.   Massachusetts           MA
  433.       Mainland                     LCC     SPAF 2001    SPAF 2001
  434.       Island                       LCC     SPAF 2002    SPAF 2002
  435.  
  436.   Michigan                MI
  437.       East    (Obsolete)           TM      SPAF 2101    ---------
  438.       Central (Obsolete)           TM      SPAF 2102    ---------
  439.       West    (Obsolete)           TM      SPAF 2103    ---------
  440.       North                        LCC     SPAF 2111    SPIF 2111
  441.       Central                      LCC     SPAF 2112    SPIF 2112
  442.       South                        LCC     SPAF 2113    SPIF 2113
  443.  
  444.   Minnesota               MN
  445.       North                        LCC     SPAF 2201    SPCS 2201
  446.       Central                      LCC     SPAF 2202    SPCS 2202
  447.       South                        LCC     SPAF 2203    SPCS 2203
  448.  
  449.   Mississippi             MS
  450.       East                         TM      SPAF 2301    SPAF 2301
  451.       West                         TM      SPAF 2302    SPAF 2302
  452.  
  453.   Missouri                MO
  454.       East                         TM      SPAF 2401    SPCS 2401
  455.       Central                      TM      SPAF 2402    SPCS 2402
  456.       West                         TM      SPAF 2403    SPCS 2403
  457.  
  458.   Montana                 MT       LCC     ---------    SPIF 2500
  459.       North                        LCC     SPAF 2501    ---------
  460.       Central                      LCC     SPAF 2502    ---------
  461.       South                        LCC     SPAF 2503    ---------
  462.  
  463.   Nebraska                NE       LCC     ---------    SPAF 2600
  464.       North                        LCC     SPAF 2601    ---------
  465.       South                        LCC     SPAF 2602    ---------
  466.  
  467.   Nevada                  NV
  468.       East                         TM      SPAF 2701    SPCS 2701
  469.       Central                      TM      SPAF 2702    SPCS 2702
  470.       West                         TM      SPAF 2703    SPCS 2703
  471.  
  472.   New Hampshire           NH       TM      SPAF 2800    SPCS 2800
  473.  
  474.   New Jersey              NJ       TM      SPAF 2900    SPCS 2900
  475.  
  476.   New Mexico              NM
  477.       East                         TM      SPAF 3001    SPAF 3001
  478.       Central                      TM      SPAF 3002    SPAF 3002
  479.       West                         TM      SPAF 3003    SPAF 3003
  480.  
  481.   New York                NY
  482.       East                         TM      SPAF 3101    SPAF 3101
  483.       Central                      TM      SPAF 3102    SPAF 3102
  484.       West                         TM      SPAF 3103    SPAF 3103
  485.       Long Island                  LCC     SPAF 3104    SPAF 3104
  486.  
  487.   North Carolina          NC       LCC     SPAF 3200    SPAF 3200
  488.  
  489.   North Dakota            ND
  490.       North                        LCC     SPAF 3301    SPIF 3301
  491.       South                        LCC     SPAF 3302    SPIF 3302
  492.  
  493.   Ohio                    OH
  494.       North                        LCC     SPAF 3401    SPCS 3401
  495.       South                        LCC     SPAF 3402    SPCS 3402
  496.  
  497.   Oklahoma                OK
  498.       North                        LCC     SPAF 3501    SPAF 3501
  499.       South                        LCC     SPAF 3502    SPAF 3502
  500.  
  501.   Oregon                  OR
  502.       North                        LCC     SPAF 3601    SPIF 3601
  503.       South                        LCC     SPAF 3602    SPIF 3602
  504.  
  505.   Pennsylvania            PA
  506.       North                        LCC     SPAF 3701    SPCS 3701
  507.       South                        LCC     SPAF 3702    SPCS 3702
  508.  
  509.   Rhode Island            RI       TM      SPAF 3800    SPCS 3800
  510.  
  511.   South Carolina          SC       LCC     ---------    SPIF 3900
  512.       North                        LCC     SPAF 3901    ---------
  513.       South                        LCC     SPAF 3902    ---------
  514.  
  515.   South Dakota            SD
  516.       North                        LCC     SPAF 4001    SPCS 4001
  517.       South                        LCC     SPAF 4002    SPCS 4002
  518.  
  519.   Tennessee               TN       LCC     SPAF 4100    SPAF 4100
  520.  
  521.   Texas                   TX
  522.       North                        LCC     SPAF 4201    SPAF 4201
  523.       North Central                LCC     SPAF 4202    SPAF 4202
  524.       Central                      LCC     SPAF 4203    SPAF 4203
  525.       South Central                LCC     SPAF 4204    SPAF 4204
  526.       South                        LCC     SPAF 4205    SPAF 4205
  527.  
  528.   Utah                    UT
  529.       North                        LCC     SPAF 4301    SPIF 4301
  530.       Central                      LCC     SPAF 4302    SPIF 4302
  531.       South                        LCC     SPAF 4303    SPIF 4303
  532.  
  533.   Vermont                 VT       TM      SPAF 4400    SPCS 4400
  534.  
  535.   Virginia                VA
  536.       North                        LCC     SPAF 4501    SPCS 4501
  537.       South                        LCC     SPAF 4502    SPCS 4502
  538.  
  539.   Washington              WA
  540.       North                        LCC     SPAF 4601    SPAF 4601
  541.       South                        LCC     SPAF 4602    SPAF 4602
  542.  
  543.   West Virginia           WV
  544.       North                        LCC     SPAF 4701    SPCS 4701
  545.       South                        LCC     SPAF 4702    SPCS 4702
  546.  
  547.   Wisconsin               WI
  548.       North                        LCC     SPAF 4801    SPAF 4801
  549.       Central                      LCC     SPAF 4802    SPAF 4802
  550.       South                        LCC     SPAF 4803    SPAF 4803
  551.  
  552.   Wyoming                 WY
  553.       East (01)                    TM      SPAF 4901    SPCS 4901
  554.       East Central (02)            TM      SPAF 4902    SPCS 4902
  555.       West Central (03)            TM      SPAF 4903    SPCS 4903
  556.       West (04)                    TM      SPAF 4904    SPCS 4904
  557.  
  558.   Puerto Rico             PR       LCC     SPAF 5201    SPCS 5200
  559.  
  560.   Virgin Islands          VI       LCC     SPAF 5201    SPCS 5200
  561.       St. Croix                    LCC     SPAF 5202    SPCS 5200
  562.  
  563.   American Samoa          AS       LCC     SPAF 5300    ---------
  564.  
  565.   Guam                    GU       PC      SPAF 5400    ---------
  566.  
  567.  See Also: {|PROJECTIONS|}SPCS
  568.  
  569. 1    PROJECTIONS
  570.  
  571.  The following are a list of the supported projections and their
  572.  required input.  Projections are usually categorized by the type
  573.  of the surface the earth is projected onto:
  574.  
  575.  - cylindrical, where the projection is a cylinder wrapped around
  576.    the globe (e.g. Mercator projection).
  577.  
  578.  - conic, where the projection is a cone placed over the globe
  579.    (e.g. Lambert Conformal Conic projection).
  580.  
  581.  - azimuthal, where the globe is projected onto a plane (e.g.
  582.    Stereographic projection).
  583.  
  584.  Other projections may be formed by modifying the basic types
  585.  (e.g. pseudo-cylindrical).  The projection type is listed below 
  586.  as the "General class" for the projection.
  587.  
  588.  In projecting a sphere (the earth) to a surface (the image), the 
  589.  geometry of the sphere is changed.  A given projection usually 
  590.  retains some characteristics of the sphere, usually at the expense 
  591.  of other characteristics.  The following terms are listed below as 
  592.  "Characteristics" for the projections where:
  593.  
  594.  - Equal-area implies a feature on one part of the map would cover
  595.    the same area, if it also occurred on any other part of the map.
  596.  
  597.  - Conformal implies "correct form or shape".  Actually it infers
  598.    the relative local angles about every point of the map as being
  599.    shown correctly.  This only applies to smaller, local areas.  
  600.    All projections distort shape for larger areas.
  601.  
  602.  - Equidistant projections show true scale between one point (or 
  603.    two points) and every other point on the map.
  604.  
  605.  - Rectangular coordinates mean that the grid of the projection
  606.    can be used to approximate distances, directions and areas
  607.    of the earth surface.  Rectangular coordinates are also
  608.    referred to as plane coordinates.
  609.  
  610.  The earth model for the projection may be defined in the MAPUNITS
  611.  string or in the ELLIPS parameter. (See the EARTH_MODELS section.)
  612.  Some projections can process the earth as an ellipsoid or a sphere,
  613.  while some only process the earth as a sphere.  This is noted for
  614.  the projection as the "Earth model:" using an "ellipsoid or sphere"
  615.  or "sphere".  This is important if the earth model is not supported
  616.  and is defined as values in the ELLIPS parameter:
  617.  
  618.  - For projections that use an "ellipsoid or sphere", ELLIPS may be
  619.    a. the semi-major axis (or equatorial radius or A) for the earth
  620.    b. the semi-minor axis (or polar radius or B) or the eccentricity
  621.       squared.
  622.    If the unsupported earth model is a sphere, this could be
  623.    defined in either of the following ways:
  624.     - do not specify a second value (i.e. only one radius is defined).
  625.     - specify the equatorial radius again (i.e. the polar radius
  626.       equals the equatorial radius).
  627.     - specify the second value as zero (i.e. the eccentricity
  628.       squared is zero).
  629.  
  630.  In general, non-azimuthal projections (i.e. cylindrical or
  631.  conic) usually use an "ellipsoid or sphere".  If no earth 
  632.  model is defined for a projection that uses an "ellipsoid or 
  633.  sphere", the earth model ellipsoid defaults to E000 (i.e. 
  634.  Clarke 1866 or NAD 1927).
  635.  
  636.  Projections that use a "sphere", will use the first value in
  637.  ELLIPS as the radius of the earth.  If there is a second value
  638.  defined, it is ignored.
  639.  
  640.  Azimuthal projections usually use a "sphere", but not an ellipsoid.
  641.  If no earth model is defined for projections that use a "sphere", 
  642.  the default will be E019 (i.e. Normal Sphere of 6370997 metres).
  643.  
  644.  The fields required for each projection are listed.  Any parameters 
  645.  not mentioned are not used for the projection.
  646.  
  647.  Possible errors are listed for each projection.  In general any 
  648.  of the projections will exit with E333 ("Projection was not 
  649.  initialized"), if the required parameters for the projection were
  650.  not specified.
  651.  
  652. 2    ACEA
  653.  
  654.   Projection     : Albers Conical Equal Area
  655.   General class  : conic
  656.   Characteristics: equal-area
  657.   Earth model    : ellipsoid or sphere
  658.  
  659.  Defining the MAPUNITS:
  660.   EASI>mapunits = "acea"          | Standard name.
  661.   EASI>mapunits = "acea e0"       | Standard name and the ellipsoid.
  662.  
  663.  Other parameters:
  664.   EASI>prolong = "central_meridian"       | Required -+- True origin
  665.   EASI>prolat  = "latitude_of_origin"     | Required /
  666.   EASI>stpar1  = "1st_standard_parallel"  | Required
  667.   EASI>stpar2  = "2nd_standard_parallel"  | Required
  668.   EASI>efalse  = "false_easting"          | Optional, default is zero
  669.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  670.  
  671.  Possible errors:
  672.   E332, "Equal latitudes for st. parallels on opposite sides 
  673.          of equator" - Error encountered in initializing for the 
  674.          projection.
  675.  
  676. 2    AE
  677.  
  678.   Projection     : Azimuthal Equidistant
  679.   General class  : azimuthal
  680.   Characteristics: neither equal-area nor conformal
  681.   Earth model    : sphere
  682.  
  683.  Defining the MAPUNITS:
  684.   EASI>mapunits = "ae"           | Standard name
  685.   EASI>mapunits = "ae e19"       | Standard name and ellipsoid
  686.  
  687.  Other parameters:
  688.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  689.   EASI>prolat  = "latitude_of_origin"     | Required /
  690.   EASI>efalse  = "false_easting"          | Optional, default is zero
  691.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  692.  
  693.  Possible errors:
  694.   E335, "Point projects into a circle" - In converting from
  695.          geographic coordinates to projection coordinates, 
  696.          the point projects into a circle.
  697.   E100, "Invalid data" - In converting from projection coordinates
  698.          to geographic coordinates, there was an input data error
  699.  
  700. 2    EC
  701.  
  702.   Projection     : Equidistant Conic
  703.   General class  : conic
  704.   Characteristics: equidistant
  705.   Earth model    : ellipsoid or sphere
  706.  
  707.  Defining the MAPUNITS (Format A or B):
  708.   EASI>mapunits = "ec"            | Standard name
  709.   EASI>mapunits = "ec e0"         | Standard name and ellipsoid
  710.  
  711.  Other parameters (Format A, one standard parallel):
  712.   EASI>prolong = "central_meridian"       | Required -+- True origin
  713.   EASI>prolat  = "latitude_of_origin"     | Required /
  714.   EASI>stpar1  = "1st_standard_parallel"  | Required
  715.   EASI>efalse  = "false_easting"          | Optional, default is zero
  716.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  717.  
  718.  Other parameters (Format B, two standard parallels):
  719.   EASI>prolong = "central_meridian"       | Required -+- True origin
  720.   EASI>prolat  = "latitude_of_origin"     | Required /
  721.   EASI>stpar1  = "1st_standard_parallel"  | Required
  722.   EASI>stpar2  = "2nd_standard_parallel"  | Required
  723.   EASI>efalse  = "false_easting"          | Optional, default is zero
  724.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  725.  
  726.  Possible errors:
  727.   E332, "Equal latitudes for st. parallels on opposite sides of 
  728.          equator " - Error occurred in initializing the projection.
  729.  
  730.  
  731. 2    ER
  732.  
  733.   Projection     : Equirectangular (Plate Carree)
  734.   General class  : cylindrical
  735.   Characteristics: neither equal-area nor conformal
  736.   Earth model    : sphere
  737.  
  738.   Defining the MAPUNITS:
  739.   EASI>mapunits = "er"           | Standard name
  740.   EASI>mapunits = "er e19"       | Standard name and ellipsoid
  741.  
  742.  Other parameters:
  743.   EASI>prolong = "central_meridian"       | Required -+- True origin
  744.   EASI>prolat  = "latitude_of_true_scale" | Required /
  745.   EASI>efalse  = "false_easting"          | Optional, default is zero
  746.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  747.  
  748.  Possible errors:
  749.   E100, "Invalid data" - In converting from projection coordinates 
  750.          to geographic coordinates, there was an input data error
  751.  
  752. 2    GNO
  753.  
  754.   Projection     : Gnomonic
  755.   General class  : azimuthal
  756.   Characteristics: neither conformal nor equal-area
  757.   Earth model    : sphere
  758.  
  759.  Defining the MAPUNITS:
  760.   EASI>mapunits = "gno"                   | Standard name
  761.   EASI>mapunits = "gno e19"               | Standard name and ellipsoid
  762.  
  763.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  764.   EASI>prolat  = "latitude_of_origin"     | Required /
  765.   EASI>efalse  = "false_easting"          | Optional, default is zero
  766.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  767.  
  768.  Possible errors:
  769.   E334, "Point cannot be projected" - In converting from geographic 
  770.          coordinates to projection coordinates, the point projects 
  771.          into infinity
  772.  
  773. 2    GVNP
  774.  
  775.   Projection     : General Vertical Near-Side Perspective
  776.   General class  : azimuthal
  777.   Characteristics: neither conformal nor equal-area
  778.   Earth model    : sphere
  779.  
  780.  Defining the MAPUNITS:
  781.   EASI>mapunits = "gvnp"         | Standard name
  782.   EASI>mapunits = "gvnp e19"     | Standard name and ellipsoid
  783.  
  784.  Other parameters:
  785.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  786.   EASI>prolat  = "latitude_of_origin"     | Required /
  787.   EASI>efalse  = "false_easting"          | Optional, default is zero
  788.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  789.   EASI>pheight = "height_of_perspective"  | Usually defined,
  790.                                           |    if defaulted is zero
  791.  Possible errors:
  792.   E334, "Point cannot be projected" - In converting from 
  793.          geographic coordinates to projection coordinates, the point 
  794.          cannot be projected.
  795.   E100, "Invalid data" - In converting from projection coordinates 
  796.          to geographic coordinates, there was an input data error
  797.  
  798. 2    LAEA
  799.  
  800.   Projection     : Lambert Azimuthal Equal-Area
  801.   General class  : azimuthal
  802.   Characteristics: equal-area
  803.   Earth model    : sphere
  804.  
  805.  Defining the MAPUNITS:
  806.   EASI>mapunits = "laea"         | Standard name
  807.   EASI>mapunits = "laea e19"     | Standard name and ellipsid
  808.  
  809.  Other parameters:
  810.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  811.   EASI>prolat  = "latitude_of_origin"     | Required /
  812.   EASI>efalse  = "false_easting"          | Optional, default is zero
  813.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  814.  
  815.  Possible errors:
  816.   E335, "Point projects into a circle" - In converting from 
  817.          geographic coordinates to projection coordinates, the 
  818.          point projects into a circle.
  819.   E100, "Invalid data" - In converting from projection coordinates 
  820.          to geographic coordinates, there was an input data error
  821.  
  822. 2    LCC
  823.  
  824.   Projection     : Lambert Conformal Conic
  825.   General class  : conic
  826.   Characteristics: conformal
  827.                  : rectangular coordinates (U.S.A.; France)
  828.   Earth model    : ellipsoid or sphere
  829.  
  830.  Defining the MAPUNITS:
  831.   EASI>mapunits = "lcc"           | Standard name
  832.   EASI>mapunits = "lcc e0"        | Standard name and ellipsoid
  833.  
  834.  Other parameters:
  835.   EASI>prolong = "central_meridian"       | Required -+- True origin
  836.   EASI>prolat  = "latitude_of_origin"     | Required /
  837.   EASI>stpar1  = "1st_standard_parallel"  | Required
  838.   EASI>stpar2  = "2nd_standard_parallel"  | Required
  839.   EASI>efalse  = "false_easting"          | Optional, default is zero
  840.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  841.  
  842.  Possible errors:
  843.   E332, "Equal latitudes for st. parallels on opposite sides of 
  844.          equator" - Error occurred in initializing the projection
  845.   E334, "Point cannot be projected" - In converting from 
  846.          geographic coordinates to projection coordinates, the 
  847.          point projects into infinity
  848.  
  849. 2    LONG/LAT
  850.  
  851.  Geographic coordinates (not a projection).
  852.   Earth model:  ellipsoid or sphere
  853.  
  854.  Defining the MAPUNITS:
  855.   EASI>mapunits="long/lat"        | Standard name.  Synonyms: "lon", 
  856.                                   |      "lat", "lat/long" or "geo"
  857.  
  858.  Other parameters: None
  859.  
  860.  Note: If a bounds is defined, it must be in geographic 
  861.  coordinates (i.e. LONG1, LAT1, LONG2, LAT2) as there is
  862.  no projection to convert from or to.
  863.  
  864. 2    MC
  865.  
  866.   Projection     : Miller Cylindrical
  867.   General class  : cylindrical
  868.   Characteristics: neither equal-area nor conformal
  869.   Earth model    : sphere
  870.  
  871.  Defining the MAPUNITS:
  872.   EASI>mapunits = "mc"           | Standard name
  873.   EASI>mapunits = "mc e19"       | Standard name and ellipsoid
  874.  
  875.  Other parameters:
  876.   EASI>prolong = "central_meridian"       | Required --+- True origin
  877.   EASI>efalse  = "false_easting"          | Optional, default is zero
  878.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  879.  
  880. 2    MER
  881.  
  882.   Projection     : Mercator
  883.   General class  : cylindrical
  884.   Characteristics: conformal
  885.   Earth model    : ellipsoid or sphere
  886.  
  887.  Defining the MAPUNITS:
  888.   EASI>mapunits = "mer"           | Standard name
  889.   EASI>mapunits = "mer e0"        | Standard name and ellipsoid
  890.  
  891.  Other parameters:
  892.   EASI>prolong = "central_meridian"       | Required -+- True origin
  893.   EASI>prolat  = "latitude_of_true_scale" | Required /
  894.   EASI>efalse  = "false_easting"          | Optional, default is zero
  895.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  896.  
  897.  Possible errors:
  898.   E334, "Point cannot be projected" - In converting from geographic 
  899.          coordinates to projection coordinates, the transform cannot 
  900.          be computed at the poles.
  901.  
  902. 2    MSC
  903.  
  904.   Projection     : Modified Stereographic Conformal
  905.   General class  : modified azimuthal
  906.   Characteristics: conformal
  907.   Earth model    : only Clarke 1866 (NAD 1927)
  908.  
  909.  Defining the MAPUNITS:
  910.   EASI>mapunits = "msc"           | Standard name
  911.  
  912.  Other parameters:
  913.   EASI>efalse  = "false_easting"          | Optional, default is zero
  914.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  915.  
  916.  Possible errors:
  917.   E330, "Calculation failed to converge to a solution" - In converting 
  918.          from projection coordinates to geographic coordinates, too 
  919.          many iterations were made.
  920.  
  921. 2    OG
  922.  
  923.   Projection     : Orthographic
  924.   General class  : azimuthal
  925.   Characteristics: neither conformal nor equal-area
  926.   Earth model    : sphere
  927.  
  928.  Defining the MAPUNITS:
  929.   EASI>mapunits = "og"           | Standard name.
  930.   EASI>mapunits = "og e19"       | Standard name and ellipsoid
  931.  
  932.  Other parameters:
  933.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  934.   EASI>prolat  = "latitude_of_origin"     | Required /
  935.   EASI>efalse  = "false_easting"          | Optional, default is zero
  936.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  937.  
  938.  Possible errors:
  939.   E334, "Point cannot be projected" - In converting from geographic 
  940.          coordinates to projection 
  941.          coordinates, the point cannot be projected.
  942.   E100, "Invalid data" - In converting from projection coordinates 
  943.          to geographic coordinates, there was an input data error
  944.  
  945. 2    OM
  946.  
  947.   Projection     : Oblique Mercator (Hotine)
  948.   General class  : cylindrical
  949.   Characteristics: conformal
  950.   Earth model    : ellipsoid or sphere
  951.  
  952.  Defining the MAPUNITS (Format A or B):
  953.   EASI>mapunits = "om"           | Standard name
  954.   EASI>mapunits = "om e0"        | Standard name and ellipsoid
  955.  
  956.  Other parameters (Format A):
  957.   EASI>prolat  = "latitude_of_origin"     | Required --- True origin
  958.   EASI>efalse  = "false_easting"          | Optional, default is zero
  959.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  960.   EASI>scale   = "scale_at_center"        | Optional, default is one
  961.   EASI>long1   = "longitude_central_line" | Required
  962.   EASI>lat1    = "latitude_central_line"  | Required
  963.   EASI>long2   = "longitude_central_line" | Required
  964.   EASI>lat2    = "latitude_central_line"  | Required
  965.  
  966.  Other parameters (Format B):
  967.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  968.   EASI>prolat  = "latitude_of_origin"     | Required /
  969.   EASI>efalse  = "false_easting"          | Optional, default is zero
  970.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  971.   EASI>scale   = "scale_at_center"        | Optional, default is one
  972.   EASI>azimuth = "azimuth"                | Required, azimuth east of 
  973.                                           |    north for central line
  974.  Possible errors:
  975.   E100, "Invalid data" - In initializing for the projection, there 
  976.          was an input data error
  977.   E334, "Point cannot be projected" - In converting from geographic 
  978.          coordinates to projection coordinates, the point projects 
  979.          into infinity
  980.  
  981. 2    PC
  982.  
  983.   Projection     : Polyconic
  984.   General class  : conic
  985.   Characteristics: neither conformal nor equal-area
  986.   Earth model    : ellipsoid or sphere
  987.  
  988.  Defining the MAPUNITS:
  989.   EASI>mapunits = "pc"            | Standard name
  990.   EASI>mapunits = "pc e0"         | Standard name and ellipsoid
  991.  
  992.  Other parameters:
  993.   EASI>prolong = "central_meridian"       | Required -+- True origin
  994.   EASI>prolat  = "latitude_of_origin"     | Required /
  995.   EASI>efalse  = "false_easting"          | Optional, default is zero
  996.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  997.  
  998. 2    PS
  999.  
  1000.   Projection     : Polar Stereographic
  1001.   General class  : azimuthal
  1002.   Characteristics: conformal
  1003.   Earth model    : ellipsoid or sphere
  1004.  
  1005.  Defining the MAPUNITS:
  1006.   EASI>mapunits = "ps"            | Standard name
  1007.   EASI>mapunits = "ps e0"         | Standard name and ellipsoid
  1008.  
  1009.  Other parameters:
  1010.   EASI>prolong = "central_meridian"       | Required -+- True origin
  1011.   EASI>prolat  = "latitude_of_true_scale" | Required /
  1012.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1013.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1014.  
  1015. 2    ROB
  1016.  
  1017.   Projection     : Robinson
  1018.   General class  : pseudo-cylindrical
  1019.   Earth model    : sphere
  1020.  
  1021.  Defining the MAPUNITS:
  1022.   EASI>mapunits = "rob"                   | Standard name
  1023.   EASI>mapunits = "rob e19"               | Standard name and ellipsoid
  1024.  
  1025.  Other parameters:
  1026.   EASI>prolong = "central_meridian"       | Required --- True origin
  1027.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1028.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1029.  
  1030.  Possible errors:
  1031.   E330, "Calculation failed to converge to a solution" - In converting 
  1032.          from projection coordinates to geographic coordinates, too 
  1033.          many iterations were made.
  1034.  
  1035. 2    SG
  1036.  
  1037.   Projection     : Stereographic
  1038.   General class  : azimuthal
  1039.   Characteristics: conformal
  1040.   Earth model    : sphere
  1041.  
  1042.  Defining the MAPUNITS:
  1043.   EASI>mapunits = "sg"           | Standard name
  1044.   EASI>mapunits = "sg e19"       | Standard name and ellipsoid
  1045.  
  1046.  Other parameters:
  1047.   EASI>prolong = "longitude_of_origin"    | Required -+- True origin
  1048.   EASI>prolat  = "latitude_of_origin"     | Required /
  1049.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1050.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1051.  
  1052.  Possible errors:
  1053.   E334, "Point cannot be projected" - In converting from geographic 
  1054.          coordinates to projection coordinates, the point projects 
  1055.          into infinity
  1056.  
  1057. 2    SIN
  1058.  
  1059.   Projection     : Sinusoidal
  1060.   General class  : pseudo-cylindrical
  1061.   Characteristics: equal-area
  1062.   Earth model    : sphere
  1063.  
  1064.  Defining the MAPUNITS:
  1065.   EASI>mapunits = "sin"          | Standard name
  1066.   EASI>mapunits = "sin e19"      | Standard name and ellipsoid
  1067.  
  1068.  Other parameters:
  1069.   EASI>prolong = "longitude_of_origin"    | Required --- True origin
  1070.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1071.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1072.  
  1073.  Possible errors:
  1074.   E100, "Invalid data" - In converting from projection coordinates 
  1075.          to geographic coordinates, there was an input data error
  1076.  
  1077. 2    SOM
  1078.  
  1079.   Projection     : Space Oblique Mercator
  1080.   General class  : modified cylindrical
  1081.   Characteristics: basically conformal
  1082.   Earth model    : ellipsoid or sphere
  1083.  
  1084.  Defining the MAPUNITS:
  1085.   EASI>mapunits = "som"           | Standard name
  1086.   EASI>mapunits = "som e0"        | Standard name and ellipsoid
  1087.  
  1088.  Other parameters:
  1089.   EASI>lsatnum = "landsat_number"         | Required
  1090.   EASI>pathnum = "path_number"            | Required
  1091.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1092.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1093.  
  1094.  Possible errors:
  1095.   E100, "Invalid data" - In initializing for the projection, the 
  1096.          Landsat satellite number and/or path number are out of range.
  1097.   E330, "Calculation failed to converge to a solution" - In converting 
  1098.          from projection coordinates to geographic coordinates, too 
  1099.          many iterations were made.
  1100.  
  1101. 2    SPCS
  1102.  
  1103.   Projection     : State Plane Coordinate System
  1104.   Characteristics: rectangular coordinates
  1105.  
  1106.   Earth model:
  1107.   Only two earth models are supported for State Plane coordinates:
  1108.   - E0, Clarke 1866 (NAD 1927)
  1109.   - E8, GRS 1980    (NAD 1983)
  1110.  These may be defined in the MAPUNITS parameter or the ELLIPS 
  1111.  parameter.  If undefined, the default earth model is E0 (Clarke 1866,
  1112.  NAD 1927).  Any other earth models will be treated as an error.
  1113.  
  1114.  Defining the MAPUNITS: 
  1115.  
  1116.  State Plane Coordinate System coordinates require a zone number to
  1117.  be defined.  This would be defined in the MAPUNITS parameter and
  1118.  would be in the range of 0101 (or 101 for Alabama, East in the 
  1119.  following examples) to 5400 (Guam).  See the SPCS_ZONES section for
  1120.  a list of the State Plane Zones.
  1121.  
  1122.   EASI>mapunits = "spcs 101"      | Standard name
  1123.   EASI>mapunits = "spcs 101 e0"   | Standard name and ellipsoid
  1124.  
  1125.  Other parameters:
  1126.  
  1127.  Depending on the defined (or default) earth model, PROSET will
  1128.  require a text file that is normally stored in /pci/etc on UNIX
  1129.  platforms.  (The search path may be different, depending on the
  1130.  platform.)  If these files are there, the NAD1927 and/or NAD1983 
  1131.  parameters may be defaulted, in which case PROSET should be able 
  1132.  to find them.  (PROSET uses the WDFF parameter, substituting "etc"
  1133.  for "wdb" (or "ETC" for "WDB"), to make up the search path.)  If 
  1134.  the pci account is not in for example /pci the text files would not 
  1135.  be found and the program would exit.  In any case the search path 
  1136.  and filename can be explicitly defined with the NAD1927 and NAD1983
  1137.  parameters.
  1138.  
  1139.   EASI>nad1927 = "nad1927_text_file"
  1140.   EASI>nad1983 = "nad1983_text_file"
  1141.  
  1142.  Possible errors:
  1143.   E331, "Invalid earth model defined for the projection" - In setting 
  1144.          up for the projection, the earth model is not E0 (Clarke 
  1145.          1866, NAD 1927) or E8 (GRS 1980, NAD 1983).
  1146.   E100, "Invalid data" - In setting up for the projection, an invalid 
  1147.          State Plane zone was entered.
  1148.   E328, "No zone was defined or could be derived for the projection" -
  1149.          In setting up for the projection, the State Plane zone
  1150.          was not specified in MAPUNITS.
  1151.  
  1152.  See Also: {|}SPCS ZONES
  1153.  
  1154. 2    TM
  1155.  
  1156.   Projection     : Transverse Mercator (Gauss-Krueger)
  1157.   General class  : cylindrical
  1158.   Characteristics: conformal
  1159.                  : rectangular coordinates (U.S.A.; Britain)
  1160.   Earth model    : ellipsoid or sphere 
  1161.  
  1162.  Defining the MAPUNITS:
  1163.   EASI>mapunits = "tm"            | Standard name
  1164.   EASI>mapunits = "tm e0"         | Standard name and ellipsoid
  1165.  
  1166.  Other parameters:
  1167.   EASI>prolong = "central_meridian"       | Required -+- True origin
  1168.   EASI>prolat  = "latitude_of_origin"     | Required /
  1169.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1170.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1171.   EASI>scale   = "scale_at_cent_meridian" | Optional, default is one
  1172.  
  1173.  Possible errors:
  1174.   E334, "Point cannot be projected" - In converting from geographic 
  1175.          coordinates to projection coordinates, the point projects 
  1176.          into infinity
  1177.   E330, "Calculation failed to converge to a solution" - In converting 
  1178.          from projection coordinates to geographic coordinates, the 
  1179.          conversion failed to converge to a solution
  1180.  
  1181. @pagebreak
  1182.  
  1183. 2    UPS
  1184.  
  1185.   Projection     : Universal Polar Stereographic
  1186.   General class  : azimuthal
  1187.   Characteristics: conformal
  1188.                  : rectangular coordinates
  1189.   Earth model    : only supported ellipsoids or spheres
  1190.                    (i.e. E000 to E019)
  1191.  
  1192.  Universal Polar Stereographic projection requires a zone to be
  1193.  specified or a sample point in geographic coordinates from which
  1194.  a zone can be derived.  If a zone is specified it would be in
  1195.  the MAPUNITS string.  Any of the following are valid:
  1196.  
  1197.  Defining the MAPUNITS:
  1198.   EASI>mapunits="ups z"           | Standard name and zone
  1199.   EASI>mapunits="ups z e0"        | Standard name, zone, and ellipsoid
  1200.  
  1201.  If the zone is not defined in the MAPUNITS string, a sample
  1202.  point can be input with PROLONG and PROLAT.  For example:
  1203.  
  1204.   EASI>mapunits = "ups"
  1205.   EASI>prolong  = "117 w"
  1206.   EASI>prolat   = " 84 n"
  1207.  
  1208.  If the UPS zone, PROLONG and PROLAT are not defined, but (BX1
  1209.  and BY1) or (BX2 and BY2) define 'LONG/LAT' point(s), one of
  1210.  these can be used to derive the UPS zone.  (If both (BX1 and 
  1211.  BY1) and (BX2 and BY2) are defined, (BX1 and BY1) is used.)
  1212.  
  1213.  If the UPS zone is derived from a sample point and the longitude
  1214.  for the point is shared between zones, the eastern-most zone is
  1215.  returned.  For example, if prolong="0 w" and prolat="84 n", the 
  1216.  assumed zone is UPS zone Z, not UPS zone Y.  Any confusion can 
  1217.  be avoided, by picking a sample point in the zone and not on the 
  1218.  zone border.
  1219.  
  1220.  Other parameters: None
  1221.  
  1222.  Possible errors:
  1223.   E331, "Invalid earth model defined for the projection"
  1224.        - In setting up for the projection, the earth model is
  1225.          not in the range of E0 to E19 and is defined explicitly
  1226.          with the ELLIPS parameter.
  1227.   E108, "Option not available"
  1228.        - In setting up for the projection, the UPS zone is 
  1229.          not A, B, Y or Z.
  1230.  
  1231. 2    UTM
  1232.  
  1233.   Projection     : Universal Transverse Mercator
  1234.   General class  : cylindrical
  1235.   Characteristics: conformal
  1236.                  : rectangular coordinates
  1237.   Earth model    : only supported ellipsoids or spheres
  1238.                    (i.e. E000 to E019)
  1239.  
  1240.  Universal Transverse Mercator projection requires a zone to be
  1241.  specified or a sample point in geographic coordinates from which
  1242.  a zone can be derived.  Once the zone is known, the central 
  1243.  meridian can be derived for the zone.  If a zone is specified 
  1244.  it would be in MAPUNITS string.  Any of the following are valid:
  1245.  
  1246.  Defining the MAPUNITS:
  1247.   EASI>mapunits="utm 11"          | Standard name and zone
  1248.   EASI>mapunits="utm 11 m"        | Standard name, zone and row
  1249.   EASI>mapunits="utm 11 m e0"     | Standard name, zone, row and ellipsoid
  1250.  
  1251.  If the zone is not defined in the MAPUNITS string, a sample
  1252.  point can be input with PROLONG and PROLAT.  For example:
  1253.  
  1254.   EASI>mapunits = "utm"
  1255.   EASI>prolong  = "117 w"
  1256.   EASI>prolat   = " 33 n"
  1257.  
  1258.  If the UTM zone, PROLONG and PROLAT are not defined, but (BX1
  1259.  and BY1) or (BX2 and BY2) define 'LONG/LAT' point(s), one of
  1260.  these can be used to derive the UTM zone.  (If both (BX1 and 
  1261.  BY1) and (BX2 and BY2) are defined, (BX1 and BY1) is used.)
  1262.  
  1263.  If the UTM zone is derived from a sample point and the longitude
  1264.  for the point is shared between zones, the eastern-most zone is
  1265.  returned.  For example, if prolong="174w", the assumed zone is
  1266.  UTM zone 2, not UTM zone 1.  Any confusion can be avoided, by 
  1267.  picking a sample point in the zone and not on the zone border.
  1268.  
  1269.  Other parameters: None
  1270.  
  1271.  Possible errors:
  1272.   E331, "Invalid earth model defined for the projection"
  1273.         - In setting up for the projection, the earth model is
  1274.           not in the range of E0 to E19 and is defined explicitly
  1275.           with the ELLIPS parameter.
  1276.   E309, "Range mistake (might be syntax or range)"
  1277.         - In setting up for the projection, the UTM zone is 
  1278.           outside the range of 1 to 60
  1279.   E328, "No zone was defined or could be derived for the projection"
  1280.         - In setting up for the projection, the UTM zone was not
  1281.           specified in MAPUNITS.
  1282.  
  1283. 2    VDG
  1284.  
  1285.   Projection     : Van der Grinten
  1286.   General class  : miscellaneous
  1287.   Characteristics: neither equal-area nor conformal
  1288.   Earth model    : sphere 
  1289.  
  1290.  Defining the MAPUNITS:
  1291.   EASI>mapunits = "vdg"          | Standard name
  1292.   EASI>mapunits = "vdg e19"      | Standard name and ellipsoid
  1293.  
  1294.  Other parameters:
  1295.   EASI>prolong = "central_meridian"       | Required --- True origin
  1296.   EASI>efalse  = "false_easting"          | Optional, default is zero
  1297.   EASI>nfalse  = "false_northing"         | Optional, default is zero
  1298.  
  1299. 1    REFERENCES
  1300.  
  1301.   Robinson, A.H., Sale, R.D., Morrison, J.L., and Muehrcke, P.C.,
  1302.   "Elements of Cartography (5th Ed.)", John Wiley and Sons,
  1303.   New York, 1984.
  1304.  
  1305.   Snyder, John P., "Map Projections - A Working Manual", U.S.G.S. 
  1306.   Professional Paper 1395, U.S. Geological Survey, 
  1307.   Reston, Virginia, 1987.
  1308.  
  1309.   "Software Documentation for GCTP, General Cartographic 
  1310.   Transformation Package", U.S. Geological Survey, National Mapping
  1311.   Division, Reston, Virginia, 1990 (Unpublished).
  1312.